PBGetForeignPrivsSync

PBGetForeignPrivsSync
Header:	Files.h		Carbon status:	Supported

Determines the native access-control information for a file or directory stored on a volume managed by a foreign file system.

OSErr PBGetForeignPrivsSync (
    HParmBlkPtr paramBlock
);

paramBlock: A pointer to a foreignPrivParam variant of the HFS parameter block.

function result: A result code.

DISCUSSION

The relevant fields of the parameter block are:

ioCompletion

On input, a pointer to a completion function.
ioResult

On output, the result code of the function.
ioNamePtr

On input, a pointer to a file or directory name
ioVRefNum

On output, a volume specification.
ioForeignPrivBuffer

On output, a pointer to the privilege information buffer.
ioForeignPrivReqCount

On input, the size allocated for the buffer.
ioForeignPrivActCount

On output, the amount used in buffer.
ioForeignPrivDirID

On input, the parent directory ID.
ioForeignPrivInfo1

On output, information specific to the privilege model.
ioForeignPrivInfo2

On output, information specific to the privilege model.
ioForeignPrivInfo3

On output, information specific to the privilege model.
ioForeignPrivInfo4

On output, information specific to the privilege model.

The PBGetForeignPrivsSync function allows your application or shell program to communicate with a foreign file system about its native access-control system. This function retrieves access permissions for a file or directory on a volume managed by a file system that uses a privilege model different from the AFP model.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.